home *** CD-ROM | disk | FTP | other *** search
/ The 640 MEG Shareware Studio 2 / The 640 Meg Shareware Studio CD-ROM Volume II (Data Express)(1993).ISO / bbs / goodu11.zip / GOODU.DOC < prev    next >
Text File  |  1992-05-17  |  9KB  |  245 lines
  1.  
  2.                        ============================
  3.                                  GoodUser!
  4.                        ============================
  5.  
  6.         One of the T&J Software Collection of multi-BBS door programs.
  7.            Supporting PCBoard, Wildcat!, Gap, QBBS, RBBS, Spitfire,
  8.               UltraBBS, Telegard, TriTel, Remote Access, and WWIV
  9.  
  10.  
  11.                           (c)1992 T&J Software
  12.  
  13.                        VERSION 1.1      05/17/92
  14.  
  15.                                     By
  16.  
  17.                                Tom Wildoner
  18.                              397 West Broadway
  19.                               Jim Thorpe, PA
  20.                                   18229
  21.                             VOICE (717)325-9480
  22.  
  23.                                    From
  24.  
  25.                                The T&J BBS
  26.                               (717)325-9481
  27.                         1200/2400/9600/19200/38400
  28.                                24 Hours/Day
  29.  
  30.  
  31. LATEST VERSION:
  32. ===============
  33. Please call the T&J BBS for the latest version of this program.
  34.  
  35. DISTRIBUTION:
  36. =============
  37. You may make this file available for downloading from your BBS or you may
  38. upload it to any BBS of your choice, provided that you do not make any
  39. changes to the contents of the archive (ZIP file). The archive and its
  40. individual contents may not be used by any service that charges any money
  41. whatsoever, without the written permission of the author.
  42.  
  43. LEGALITIES:
  44. ===========
  45.       THIS SOFTWARE AND ACCOMPANYING MATERIALS ARE DISTRIBUTED "AS IS"
  46.       WITHOUT WARRANTY, EXPRESS, IMPLIED OR STATUTORY, INCLUDING BUT NOT
  47.       LIMITED TO ANY IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
  48.       FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL ANYONE INVOLVED WITH
  49.       THE CREATION AND PRODUCTION OF THIS PRODUCT BE LIABLE FOR INDIRECT,
  50.       SPECIAL, OR CONSEQUENTIAL DAMAGES, ARISING OUT OF ANY USE THEREOF
  51.       OR BREACH OF ANY WARRANTY.
  52.  
  53. PROGRAM DESCRIPTION:
  54. ====================
  55. Special thanks to Robert Cole from Mustang Software for this idea!
  56.  
  57. This door works exactly opposite of BadUser (by T&J Software). By
  58. editing the GOODUSER.LST file you can allow only your good users to
  59. enter door games. Great for a tournament play between a select group
  60. of users on your board.
  61.  
  62. If a "Good User" is found, he is told that his access has been granted
  63. to the selected door. If a person is not listed in the GOODUSER.LST
  64. file, he is told that he does not have access to the door.
  65.  
  66.  
  67. CONFIGURATION:
  68. =============
  69.  
  70. Example configuration file for PCBOARD.SYS
  71. ------------------------------------------
  72.  
  73. C:\PCB\PCBOARD.SYS  <=-  (Full pathname of your PCBOARD.SYS file)
  74. T&J Software        <=-  (Change this to your BBS name)
  75. Tom                 <=-  (The Sysop's first name)
  76. Wildoner            <=-  (The Sysop's last name)
  77.  
  78. Example configuration file for USERS.SYS
  79. ----------------------------------------
  80.  
  81. C:\PCB\USERS.SYS    <=-  (Full pathname of your USERS.SYS file)
  82. T&J Software        <=-  (Change this to your BBS name)
  83. Tom                 <=-  (The Sysop's first name)
  84. Wildoner            <=-  (The Sysop's last name)
  85.  
  86. Example configuration file for DOOR.SYS
  87. ---------------------------------------
  88.  
  89. C:\BBS\DOOR.SYS     <=-  (Full pathname of your DOOR.SYS file)
  90. T&J Software        <=-  (Change this to your BBS name)
  91. Tom                 <=-  (The Sysop's first name)
  92. Wildoner            <=-  (The Sysop's last name)
  93.  
  94. Example configuration file for USERINFO.DAT
  95. -------------------------------------------
  96.  
  97. C:\BBS\USERINFO.DAT <=-  (Full pathname of your USERINFO.DAT file)
  98. T&J Software        <=-  (Change this to your BBS name)
  99. Tom                 <=-  (The Sysop's first name)
  100. Wildoner            <=-  (The Sysop's last name)
  101. NOTE: DOOR.SYS must be in the SAME directory as USERINFO.DAT
  102.  
  103. Example configuration file for CALLINFO.BBS
  104. -------------------------------------------
  105.  
  106. C:\BBS\CALLINFO.BBS <=-  (Full pathname of your CALLINFO.BBS file)
  107. T&J Software        <=-  (Change this to your BBS name)
  108. Tom                 <=-  (The Sysop's first name)
  109. Wildoner            <=-  (The Sysop's last name)
  110.  
  111. Example configuration file for DORINFOx.DEF
  112. -------------------------------------------
  113.  
  114. C:\BBS\DORINFOx.DEF <=-  (Full pathname of your DORINFOx.DEF file
  115.                           where 'x' is the BBS Node number.
  116. T&J Software        <=-  (Change this to your BBS name)
  117. Tom                 <=-  (The Sysop's first name)
  118. Wildoner            <=-  (The Sysop's last name)
  119.  
  120. Example configuration file for SFDOORS.DAT
  121. ------------------------------------------
  122.  
  123. C:\BBS\SFDOORS.DAT  <=-  (Full pathname of your SFDOORS.DAT file)
  124. T&J Software        <=-  (Change this to your BBS name)
  125. Tom                 <=-  (The Sysop's first name)
  126. Wildoner            <=-  (The Sysop's last name)
  127.  
  128. Example configuration file for CHAIN.TXT
  129. ----------------------------------------
  130.  
  131. C:\BBS\CHAIN.TXT    <=-  (Full pathname of your CHAIN.TXT file)
  132. T&J Software        <=-  (Change this to your BBS name)
  133. Tom                 <=-  (The Sysop's first name)
  134. Wildoner            <=-  (The Sysop's last name)
  135.  
  136. Example configuration file for GTUSER.BBS
  137. -----------------------------------------
  138.  
  139. C:\BBS\GTUSER.BBS   <=-  (Full pathname of your GTUSER.BBS file)
  140. T&J Software        <=-  (Change this to your BBS name)
  141. Tom                 <=-  (The Sysop's first name)
  142. Wildoner            <=-  (The Sysop's last name)
  143. 1                   <=-  (COM port number - defaults to 1)
  144. 1                   <=-  (Node number - defaults to 1)
  145.  
  146. This Door is multi-node  compatible so you may run more than 1 node from
  147. the same .CFG file provided the path to your system file (DORINFOx.DEF,
  148. CALLINFO.BBS, etc) is exactly the same unless you are using environment
  149. variables, (q.v.)
  150.  
  151. Environment Variables
  152. =====================
  153.  
  154. PCBoard automatically creates the %PCBDRIVE% & %PCBDIR% environment
  155. variables. Non-PCBoard systems may also use these variables by including
  156. the following in either your BBS batch or AUTOEXEC.BAT
  157.   SET PCBDRIVE=C:               <- Drive letter of your BBS files
  158.   SET PCBDIR=\BBSDIR            <- Path to your BBS files
  159. Then in your Door .CFG file instead of putting C:\BBSDIR\DOOR.SYS, you
  160. would put %PCBDRIVE%%PCBDIR%\DOOR.SYS. This allows you to use just one
  161. .CFG file for multi-node operation!
  162.  
  163. To specify a non-standard IRQ, put the IRQ number after the .CFG on the
  164. command line.  For example:
  165.  
  166.      LEMON30 LEMON.CFG /5
  167. or using the PCBDRIVE procedure:   SET IRQ=5   and use
  168.      LEMON30 LEMON.CFG /%IRQ%
  169.  
  170. This tells the program to use IRQ 5 instead of the standard IRQ.
  171.  
  172.  
  173. Sysop Keys
  174. ==========
  175.  
  176. F3    -  Toggles the printer On/Off. Value is passed to PCBoard and/or
  177.          written to DOOR.SYS and USERS.SYS
  178. F4    -  Toggles the Page Bell on/off. Value is passed to PCBoard
  179.          and/or written to DOOR.SYS and USERS.SYS
  180. F5    -  DOS Shell. Allows SysOp to exit to DOS from inside a DOOR.
  181. F7    -  Toggles the Caller Alarm On/Off. Value is passed to PCBoard
  182.          and/or written to DOOR.SYS and USERS.SYS
  183. F8    -  Returns the caller involuntarily to the BBS.
  184. F9    -  Toggles the local display On/Off. Value is passed to PCBoard
  185.          and/or written to DOOR.SYS and USERS.SYS
  186. F10   -  Activates SysOp CHAT mode within the DOOR.
  187. ESC   -  Deactivates CHAT mode.  DOOR is resumed.
  188. UP    -  Give the caller extra time while in the DOOR.  
  189. DN    -  Subtract time from the caller while in the DOOR. 
  190. HOME  -  HELP key for Status Line options.
  191. ALT-N -  SysOp next on toggle. Value passed to PCBoard. (PCBoard only)
  192. ALT-X -  PCBoard will exit after current caller logs off. Value is
  193.          passed to PCBoard. Not available on non-PCBoard systems.
  194.  
  195. SAMPLE DOOR BATCH FILE:
  196. ======================
  197.  
  198. ECHO OFF
  199. CD\WC30\DOOR\LEMON
  200. GOODU10 GOODUSER.CFG
  201. IF EXIST BAD.BAD GOTO QUIT
  202. LEMON LEMON.CFG
  203. :QUIT
  204. IF EXIST BAD.BAD DEL BAD.BAD
  205.  
  206. 1: Turn ECHO OFF -- not needed
  207. 2: Change to your door directory.
  208. 3: Run GoodUser -- if an unlisted user is found the program will create a
  209.    small file called BAD.BAD.
  210. 4: Checks to see if BAD.BAD was created -- if it was it will skip to
  211.    QUIT and bypass the real door. If the BAD.BAD file is not found
  212.    your real door will operate as normal.
  213. 5: Your actual door program (however many lines it takes).
  214. 6: Batch file branch if an unlisted user was found.
  215. 7: Delete the BAD.BAD file if it is there.
  216.  
  217. To run in LOCAL mode simply enter: LOCAL
  218.  
  219. EDITING THE GOODUSER.LST FILE:
  220. =============================
  221. Simply add one name per line. This is your list of users who have access
  222. to the door.
  223.  
  224. FUTURE VERSIONS:
  225. ================
  226. --->> Let me know what you would like to see!
  227.  
  228. VERSION HISTORY:
  229. ================
  230. Version 1.00 ......... First release. 03/14/92
  231. Version 1.10 ......... Updated routines. 05-17-1992
  232.  
  233.  
  234. REGISTERING:
  235. ============
  236. None required. If you would like to send me a program you have written,
  237. that would be payment enough.
  238.  
  239.  
  240. That's all there is to it! If you have any problems or questions
  241. please feel free to call the T&J BBS at (717)325-9481 and join the
  242. T&J Software Conference.
  243.  
  244. See the registration form for other products from T&J Software.
  245.